/** 
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
package it.free.i.virtual;

import it.free.i.virtual.machine.hal.LinkingOperationException;

import java.util.Properties;

/**   
 * Define the paradigm for a software entity that can be linked, doing a sort of setup
 * @author stefano
 */
public interface Linkable {

	/**
	 * Link the underlaying hardware allocating resources
	 * @param virtualDeviceConfiguration is the bunch of properties to pass to the impl
	 * @throws LinkingOperationException
	 */
	public void link(Properties virtualDeviceConfiguration) throws LinkingOperationException;
	
	/**
	 * Unlink resources allocated
	 * @throws LinkingOperationException
	 */
	public void unlink() throws LinkingOperationException;
	
}
